docs: rework deployment & hosting for marketplaces + Helm#1045
Merged
Conversation
Make the cloud marketplaces the promoted way to run Arcade in your own infrastructure, with bare Helm as the do-it-yourself alternative, and remove the stale self-hosting content. New pages: - Azure Marketplace: full deploy guide (managed application in the customer's own subscription, operated by Arcade). - AWS: private-offer overview with a request-access CTA. - GCP: coming soon, planned architecture, and a Helm-on-GKE pointer. - Self-host with Helm: high-level guide that links out to the Artifact Hub values reference instead of duplicating it. - Shared IdentityProviderSetup component reused across all four guides. Fix the stale self-hosting story: - Remove the obsolete configure-engine page. Self-hosting the standalone engine binary is no longer supported; configuration is via Helm values. - Rewrite the Overview as a decision guide and clarify that Arcade Deploy and Warp Pipes are features, not platform deployments. - Retitle the mislabeled "On-premises MCP servers" page to "Hybrid MCP servers" (slug kept so existing links stay valid). - Warp Pipes: repoint dead configure-engine/on-prem links and convert its engine.yaml snippets to Helm values. - Repoint ~10 auth-provider "self-hosted engine" links and arcade-cloud to the new Helm page; add redirects for the removed page. Verification: ultracite lint, _meta key check, redirect check, and the broken-link/internal-link tests pass; all pages render in dev. Note: outbound marketplace listing/contact URLs are TODO placeholders to be filled in before publishing. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
- Azure: simpler "managed by Arcade" phrasing; managed hostname only (<id>.az.myarcade.dev), drop unsupported bring-your-own-domain; real Marketplace listing link; plural redirect URIs shown in deploy outputs. - AWS: real Marketplace seller link; drop the "being finalized" note; add managed hostname (<id>.aws.myarcade.dev). - Shared IdP setup: point to the redirect URIs shown in the deployment outputs; remove the AADSTS500113 troubleshooting note. - Helm: bundled Postgres/Redis are for POC (bring your own for production); drop the pinned --version from the install command. - Warp Pipes: drop the pinned --version from the helm upgrade example. - GCP: use the arcade.dev contact link for early access. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The shared IdentityProviderSetup React component rendered raw <ol>/<li>, which don't pick up Nextra's list typography, so the steps rendered cramped. Inline the setup steps as native markdown in the Azure, AWS, and Helm guides (properly styled) and remove the component. Also drops the AADSTS500113 troubleshooting note. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
vfanelle
approved these changes
Jul 2, 2026
vfanelle
left a comment
vfanelle
left a comment
Contributor
There was a problem hiding this comment.
LGTM — docs-only rework, link checks pass. Noted the outbound marketplace URLs are still TODO placeholders per the reviewer notes; make sure those get filled before publishing.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
Our deployment docs were out of date: there were no marketplace or Helm pages, the only "self-host the platform" content was a Contact us stub, the
configure-enginepage documented a standalone-engine self-host path that no longer exists, and theon-prempage was mislabeled (it's actually the hybrid-tunnel model, yet ~10 auth-provider pages linked to it as "self-hosting Arcade").This PR reworks Deployment & hosting so the cloud marketplaces are the promoted path for running Arcade in your own infrastructure, with bare Helm as the do-it-yourself alternative, and removes the stale self-hosting content.
Changes
New pages
oci://public.ecr.aws/s5i6x9d1/charts/arcadeinstall command) that links out to the Artifact Hub values reference instead of duplicating it.IdentityProviderSetupcomponent — shared OIDC setup step (create app → client ID/secret + issuer → redirect URI →AADSTS500113note) reused by all four guides.Fixes to the self-hosting story
configure-enginepage (added a redirect).on-prem→ "Hybrid MCP servers" (slug kept, so lifecycle links stay valid).configure-engine/on-premlinks and convertedengine.yamlsnippets to Helm values.arcade-cloudto the new Helm page; updated_meta.tsxand 3 redirects innext.config.ts.Verification
ultracitelint,_meta.tsxkey check, redirect checkbroken-link-check+internal-link-checkvitest suites (all internal links + anchors resolve, incl.helm#configurationand the repointed links)Reviewer notes
{/* TODO */}placeholders and must be filled before publishing: Azure Marketplace listing, AWS private-offer/contact, GCP early-access/contact.🤖 Generated with Claude Code
Note
Low Risk
Documentation and redirect changes only; no application code. Main risk is readers missing the removed engine.yaml reference until they follow redirects to Helm.
Overview
Reworks Deployment & hosting so customers can choose Arcade Cloud, cloud marketplaces (Azure/AWS/GCP), or self-host with Helm, and stops presenting obsolete standalone-engine self-host docs as the path.
New guides cover Azure Marketplace (managed app in the customer subscription), AWS (private offer), GCP (coming soon + Helm on GKE), and Self-host with Helm (OCI install, values via Artifact Hub). The overview is rewritten as a decision guide: marketplaces/Helm are full platform deploys; Arcade Deploy, Hybrid MCP servers, and Warp Pipes are called out as features on top of Arcade, not platform installs.
Removals and renames: the long
configure-enginepage is deleted (redirects innext.config.tssend old URLs to Helm).on-premis retitled Hybrid MCP servers (slug unchanged). Warp Pipes prerequisites and SSRF allowlist examples move fromengine.yamlto Helm values and the public OCI chart URL.Cross-link fixes:
arcade-cloud,arcade-deploy, and many auth-provider pages now point self-hosting readers at/guides/deployment-hosting/helminstead ofconfigure-engineor mislabeled on-prem. Nav_meta.tsxandpublic/llms.txtare updated to match.Reviewed by Cursor Bugbot for commit 00fdafd. Bugbot is set up for automated code reviews on this repo. Configure here.